### 功能描述

启动作业执行方案

### 请求参数

#### Body参数

| 字段              | 类型      | 必选  | 描述                                                                          |
|-----------------|---------|-----|-----------------------------------------------------------------------------|
| bk_scope_type   | string  | 是   | 资源范围类型。可选值: biz - 业务，biz_set - 业务集                                          |
| bk_scope_id     | string  | 是   | 资源范围ID, 与bk_scope_type对应, 表示业务ID或者业务集ID                                     |
| bk_biz_id       | long    | 是   | *已弃用*。业务ID。此字段已被弃用并由字段bk_scope_type+bk_scope_id替换                           |
| job_plan_id     | long    | 是   | 作业执行方案ID                                                                    |
| global_var_list | array   | 否   | 全局变量。对于作业执行方案中的全局变量值，如果请求参数中包含该变量，则使用传入的变量值；否则使用执行方案当前已配置的默认值。定义见global_var |
| callback_url    | string  | 否   | 回调URL，当任务执行完成后，JOB会调用该URL告知任务执行结果。回调协议参考callback_protocol组件文档               |
| start_task      | boolean | 否   | 是否启动任务，默认true，如果是false可以通过operate_job_instance接口启动任务                        |

##### global_var

| 字段     | 类型     | 必选  | 描述                                |
|--------|--------|-----|-----------------------------------|
| id     | long   | 否   | 全局变量id，唯一标识。如果id为空，那么使用name作为唯一标识 |
| name   | string | 否   | 全局变量name                          |
| value  | string | 否   | 字符、密码、数组、命名空间类型的全局变量的值            |
| server | object | 否   | 主机类型全局变量的值，见server定义              |

##### server

| 字段                 | 类型    | 必选  | 描述                        |
|--------------------|-------|-----|---------------------------|
| host_id_list       | array | 否   | 主机ID列表                    |
| ip_list            | array | 否   | 静态 IP 列表，定义见ip            |
| dynamic_group_list | array | 否   | 动态分组列表，定义见dynamic_group   |
| topo_node_list     | array | 否   | 动态 topo 节点列表，定义见topo_node |

##### ip

| 字段          | 类型     | 必选  | 描述     |
|-------------|--------|-----|--------|
| bk_cloud_id | int    | 是   | 管控区域ID |
| ip          | string | 是   | IP地址   |

##### dynamic_group

| 字段  | 类型     | 必选  | 描述         |
|-----|--------|-----|------------|
| id  | string | 是   | CMDB动态分组ID |

##### topo_node

| 字段        | 类型     | 必选  | 描述                                                  |
|-----------|--------|-----|-----------------------------------------------------|
| id        | long   | 是   | 动态topo节点ID，对应CMDB API 中的 bk_inst_id                 |
| node_type | string | 是   | 动态topo节点类型，对应CMDB API 中的 bk_obj_id,比如"module","set" |

### 请求参数示例

- POST

```json
{
    "bk_scope_type": "biz",
    "bk_scope_id": "1",
    "job_plan_id": 100,
    "global_var_list": [
        {
            "id": 436,
            "server": {
                "dynamic_group_list": [
                    {
                        "id": "blo8gojho0skft7pr5q0"
                    }
                ],
                "host_id_list": [
                    101,
                    102
                ],
                "topo_node_list": [
                    {
                        "id": 1000,
                        "node_type": "module"
                    }
                ]
            }
        },
        {
            "name": "param_name",
            "value": "param_value"
        }
    ]
}
```

### 返回结果示例

```json
{
    "result": true,
    "code": 0,
    "data": {
        "job_instance_name": "Test",
        "job_instance_id": 10000
    },
    "job_request_id": "xxx"
}
```

### 返回结果参数说明

{% include '_generic_response.md.j2' %}

##### data

{% include '_generic_response_job_instance.md.j2' %}

